Almathera Ten Pack 3: CDPD 3/Almathera Ten on Ten - Disc 3: CDPD3.iso/scope/001-025/scopedisk13/m2du360/m2du360.docs

Text File | 1995-03-18 | 18KB | 485 lines

M2Du 3.60
~~~~~~~~~
 - By Greg Browne - 1821 Ocotillo, Alamogordo NM 88310  [phone]

DirUtil in Modula-2 - 50-1000 files CLI or WB
 Last modified - 6/10/88

CONTACT:

CIS [72250,106]
Alamo FastKode ROS (505)-437-2280 (24 hr 300-9600 baud)
New Horizons (505)-437-9117 (7pm-8am 300-2400)

DISCLAIMER:
 I am not responsible for anything! Use at your own risk.

P.D. NOTICE:
 This executible is placed in the public domain. FREE!

THANKS:
 Richie Bielack, Martin Taillefer, Matt Dillon, Brett Blevins,
 Jim Kunzman, Chuck Layton, Rick Sinars and others for various reasons.

WARNING -  *MAJOR* CHANGES BACK IN 3.42.

+++++++++++++++++
GENERAL OPERATION
+++++++++++++++++

CLITail:
Accepts arguments (not in WB yet):
  i = Incr max files-per-dir by 50 (multiple 'i' ok).
  d = Decr max files-per-dir by 50 (multiple 'd' ok).

COMMAND ACTIVATION:
LEFT & RIGHT mouse button press & RELEASE over gadget (or name) to register.

CONFIRMING:
Messy & destructive commands need confirmation.  When asked to "HIT (name)
again", USE THE LEFT MOUSEBUTTON.  The right mousebutton will NOT confirm
actions, even those started with the right mousebutton.


INTERRUPTING:
Multi-actions interrupt by clicking a gadget (including filewindow) with the
LEFT mousebutton.  Stop is AFTER current pass is complete. When the alternate
pointer is visible, clicks are ONLY interrupts.

Getting files interrupts with a click in the filewindow. If directory has
too many files, you will be warned.

EXECUTE/RUN:
DO, EDIT, & SHOWIFF execute sequentially (prevent disk grinding) until the
last (or only) action. Then RUN >NIL: is used to free up Du. When commands
finish, they do NOT re-read the directory (save more grinding when command
is RUN).  Use hidden 'S' gadget to re-read.


TITLE BAR:
 nnn/tttt  Time 00:00   R-0   Chip nnnnnn  Fast nnnnnnn  Total  nnnnnnnn
---------  ----------   ---   ------------------------------------------
current      24 hr       Which              Memory availability
  files/max    format      history item active

INITIAL DIRECTORY:
Logs into ram: if run from WorkBench. Logs into Current Dir from CLI.

SIZING WINDOW:
Normal AND 'hidden' gadget. Instantly shrink by clicking the open space
below the title bar. Unshrink by clicking hanging space below the title in
the tiny window.  Tiny window moves - remembers where it was.

DEVICE GADGETS: -> df0: df1: ... etc.
LEFT mouse  = put this into S with immediate 'GET'.
RIGHT mouse = put this into the D gadget.  [Patchable. See end of this doc]

FILEWINDOW GADGET:
Click unselected file OR dir and it is "selected". Click a selected name to
unselect it. Most actions need "selected" things to work.

NOTE: Any/all filenames AND/OR DIRS may be selected at once.
      See "HIDDEN GADGETS" for a 'HOLD' feature in display.

SLIDER GADGET:
Scroll filename window. If slider is filled, all files and directories are
displayed.

/\ and \/:
 LEFT mouse  = move 1 file in arrow direction
 RIGHT mouse = move 1 SCREEN in arrow direction

MULTIPLE R GADGETS (HISTORY):
'R' holds a circular list of 10 strings. "R+ R-" scrolls them, and R#:n in
title bar tells which one is in use. Startup looks for a file named Du.hist
in the current directory, and if not found, in the S: directory. FIRST one
found will be used to initialize the strings to = the first 10 lines of the
file. If NEITHER found, all R gadgets will be empty.  The file is just
lines in plain text, and anything over 10 lines will be ignored. A sample
file is included.

History changes must be typed in AND <ENTER>ed while program waits for
normal gadget activity to be permanent.  Remember, while commands are going
on, the program only looks at gadget selection as an interrupt.  Changes
made during activity, OR ended without <ENTER>ing will be TEMPORARY. Then,
scrolling history +- will return last saved history for that item.
Experiment with it.

STRING I/O GADGETS: ->  R  S  D

All are 255 characters long, but only part of string is seen. To view a
long string, activate the gadget, and use arrows to move through it.

(R)un holds command line info for RUN f<ile>+R.  May also be used alone
 OR as the lead item in a command with highlighted file as tail if RUN
 R+f<ile> used. SEE ALSO HISTORY ABOVE AND THE 'R+ R-' button section.

(S)ource holds name of the current active device or dir. LEFT mouseclick a
 device gadget and its goes here. CLICK, TYPE, AND <ENTER> in this gadget,
 and your entry will be new current device or dir. If access to it fails,
 the program returns to the last good active dir (or to ram: if that fails).
 Click the RIGHT mousebutton IN the box and a PARENT command is done.

(D)estination holds the name of the path (filename in some cases) to use
 for certain GADGET functions. Clicking the RIGHT mousebutton IN the box
 backs the name up to its PARENT level (if any).

The Message area at the bottom is NOT a gadget.

HIDDEN GADGETS:
Click LEFT mousebutton on LETTER 'R' or 'D' to blank contents of the box.
Click LETTER 'S' for directory re-read of 'S'.
RIGHT mouse on "S" toggles mode and color.
  Black (original color) means re-reads always display from file number 1.
  Green (same as device names) means re-reads try to display from the same
  position as last one. [For comparing similar directories or seeing changes
  in the middle of one.]

Finally, there is another unmarked gadget mentioned.
Find it yourself (may encourage someone to read this stuff).


+++++++++++++++
BUTTON GADGETS: (alphabetically - sortof) Gadgets NOT alphabetic on screen
+++++++++++++++

  COPY     (Multifile - consecutive)
  ----
Copy any/all selected file(s) to PATH in D (must be a valid device or dir).
Multiple copy supported, copy to specific filename not supported. Checks
PROTECT gadget setting.
 LEFT mouse  = STOP if file status does not match PROTECT gadget.
 RIGHT mouse = SKIP that file and go on.


  COPYALL  (CONFIRMED) (Mass file/directory copy)
  -------
Copy entire dir/disk contents, matching tree structure on the fly.  Put
base level source dir name in S and the base dest PATH in D and select
COPYALL (and confirm). This copies EVERYTHING in S AND ITS SUBDIRECTORIES
to D, creating directories as it goes. IF destination fills, you will have
a chance to change disks and continue.

 Ex: Copy entire disk (like COPY df0: to df1: all)
       type 'df0:' in S and 'df1:' in D and go.
     Copy devs directory
       Put 'df0:devs' in S and 'df1:devs' (existing OR NOT) in D, and
       start. Creates (if needed) destination directory, copies all files,
       creates df1:devs/printers (if needed) and copies all its files.

Specifically confirmed, DOES NOT check PROTECT setting.

  COPYif  (CONFIRMED)
  ------
Just like COPYALL, BUT with attention to ARC bit of source FILE's protection
bits. If bit is CLEAR (file changed since last set) it WILL copy the file.
If a DIRECTORY bit is SET it doesn't even go into that directory.
 LEFT mouse  = SET source ARC bit after copy done
 RIGHT mouse = DON'T mess with ARC bit

  DELDIR  (CONFIRMED)
  ------
DIRECTORY delete. To work, dir must be selected and EMPTY. ANY/ALL
highlighted directories will be deleted if empty.
 LEFT mouse  = stop if a directory doesn't delete.
 RIGHT mouse = continues EVEN if a directory doesn't delete

  DELETE   (CONFIRMED) (Multifile - consecutive)
  ------
FILE delete. Any/all files currently highlighted will be deleted. Message
area shows progress, and delete may be stopped by clicking left mouse
button on any gadget (including filewindow).

  DSKCOPY  (CONFIRMED)
  -------
Diskcopy 'S' to 'D'  - BOTH MUST BE df0-df3.  Corrects date so DOS won't be
confused.  IS Interruptible.
 LEFT mouse  = NOVERIFY
 RIGHT mouse = VERIFY

  DSKWIPE   (CONFIRMED)
  -------
QUICK WIPE OF disk in 'D'.  MUST BE df0-df3.  Writes fresh root block.
 LEFT mouse  = NOVERIFY
 RIGHT mouse = VERIFY


  DO f+R  DO R+f   (Multifile - consecutive)
  ------  ------
RUN/EXECUTE command.
 DO R+f executes the 'R' contents with selected items as a tails.
 DO f+R executes selected items with the 'R' content as a tail.
 If no item is selected, both try the R gadget alone.
Uses DOS Execute (like typing a command at > prompt). Also whether command
is RUN or executed depends on other things (more info in first section).
This is NOT like script handler 'EXECUTE'.

*DOES* INCLUDE HIGHLIGHTED DIRECTORY NAMES IN THE ACTIONS

  EDIT     (Multifile - consecutive)
  ----
Start editor with selected FILEname(s) as tail(s). If no file selected,
editor will be RUN with no file.  Expects editor named 'dme' in normal
search path and uses the same Execute/Run logic as DO buttons (SEE
PATCHING).

  FORMAT
  ------
FORMAT disk indicated in 'D'.  MUST BE df0-df3. Names disk "New" and uses
current date.  DOES INSTALL as bootable. IS Interruptible.
 LEFT mouse  = NOVERIFY
 RIGHT mouse = VERIFY

  F+ F-
  -----
Change #files-per-directory handled by DU.
 LEFT mouse  = increase 50
 RIGHT mouse = decrease 50. (More files = more memory used.)

  GETDIR   (NO SUCH GADGET)
  ------
GETDIR by clicking the RIGHT mouse button over its name.

  HPRINT  HTYPE  PRINT  TYPE
  ------  -----  -----  ----
ASCII/HEX file view/print. Destination of PRINT/HPRINT selected with toggle
gadget PRT: (See TOGGLES/FLAGS section). Multiple hardcopy runs interrupt
the same way as other functions. To scroll back and forth in file during
screen output, click left mouse down in upper or lower part of window, or
use scroll bar. Click title bar to quit or interrupt an individual printout
or display. Tabs expanded on 8 columns. NO color sequences or formfeeds.
Line xx of xxx shown in the title bar.  For PRINT this is 256 byte blocks
NOT lines.

NOTE:
 If PRINT/HPRINT selected with RIGHT mouse, formfeed will be sent after
 each file.

  INFO
  ----
LEFT mouse  = FREE space S and/or D
RIGHT mouse = USED space S and/or D.  Both show volume name[s].

  INSTALL
  -------
INSTALL disk indicated in 'D'.  MUST BE df0-df3. Writes fresh boot block.
 LEFT mouse  = NOVERIFY
 RIGHT mouse = VERIFY

  MAKEDIR
  -------
Make dir named in the D gadget (if valid and not existing). If complete
dev:path not given, dir will be made relative to the path in S. Check is
made to insure you are not trying to create a directory with an already
existing name (or over a file).
 LEFT mouse  = DO re-read S when done
 RIGHT mouse = DON'T re-read.

  MOVE     (Multifile - consecutive)
  ----
MOVE items to destination (must be path). Tries RENAME. If that fails, and
'item' is NOT a directory, tries copy-and-delete-source. DOES check state
of the PROTECT gadget.
 LEFT mouse  = STOP if item does not match PROTECT gadget status
 RIGHT mouse = SKIP that item and go on.

*WARNING* - A bug in the ram-handler lets you rename a file in ram: to an
 existing name in ram: without a DOS error 203 and leaves you 2 in the same
 directory. Just so you will be aware, I didn't try to trap that.
 (* vd0: also does that! *)

  OldNew
  ------
Tag files based on destination condition.
 LEFT mouse  = tag files which DO exist at dest end (Old)
 RIGHT mouse = tag files which DO NOT exist at dest end (New).

  PARENT
  ------
Click RIGHT mousebutton in 'S' or 'D' box for PARENT.

  ROOT
  ----
Back up to the root of the current S or D gadget. If this fails with 'S',
return to the last good current directory (or ram: as a last resort).
  LEFT mouse  = Get ROOT of 'S'
  RIGHT mouse = Backup 'D' to its ROOT level

  RELABEL
  -------
Relabel disk in 'S' to NAME in 'D', both in memory and on disk. Internal.
'D' gadget cannot have ":" or "/" in it.

  RENAME
  ------
Rename FIRST selected file OR dir (alphabetically) to Name in the D gadget.
Wherever practical, MOVE is faster.
 LEFT mouse  = re-read directory (since it may be still be there)
 RIGHT mouse = NO re-read (old dropped, new not added even if still there).

  TAGALL RETAG FLIPTAG UNTAG
  ------ ----- ------- -----
Mass tag operations on all items in a window.
(In some DU's -> TAGALL = ALL   UNTAG = CLEAR)

TAGALL selects ALL items. RETAG after multifile operations reselects any
items selected before (if they remain now). FLIPTAG reverses all tags.
UNTAG clears all tags.

 LEFT mouse  = do with FILES.
 RIGHT mouse = do with DIRECTORIES.

  SETNOTE
  -------
Set filenote of FIRST HIGHLIGHTED file OR dir. Current R gadget content
will be used as comment.  To delete a comment, empty R gadget and SETNOTE
(to null comment).

  SHONOTE
  -------
Show filenote (if any) of FIRST HIGHLIGHTED file. Filenote will be shown in
the message area. If [-no comment-] appears, file has no filenote attached
to it.

  SETPROT
  -------
Set protection bits on highlighted FILE(s) OR DIR(s).
  LEFT mouse  = work this on FIRST item found highlighted.
  RIGHT mouse = work this on ALL items highlighted.

R gadget must hold letter(s) of bits you want SET. Does NOT consider
CURRENT condition of flags - you must include ALL letters you want set. To
get current status, use SHOPROT. Order of letters does NOT matter. Letters
not present will have their bits CLEARED.

 Protection bits are (UPPER or lower case o.k.):
  A(rchive bit)           Currently RESET each time a file is changed
  R(ead protect bit)      Ignored by DOS now
  W(rite protect bit)     Ignored by DOS now
  E(xecute protect bit)   Ignored by DOS now
  D(elete protect bit)    Prevents deletion when SET

  SHOPROT
  -------
Shows protection bit status on highlighted file OR directory.
Uses current R gadget, so be careful of History items.
 LEFT mouse  = show NEXT highlighted (and unselect)
 RIGHT mouse = scan quickly through ALL highlighted (and unselect)

  SHOWIFF
  -------
Picture display. INTERNAL - does NOT need any "Show" program. Works on
most wellbehaved ILBM files. Based on UShow2.asm logic.

  ZAPALL
  ------
Mass directory-and-related-files delete. Works two ways.

1) If a directory name IS highlighted when ZAPALL is selected, it assumes
   you want to delete that directory AND ALL FILES AND SUBDIRECTORIES IN IT.

2) If NO directory name highlighted, it assumes you want to delete CONTENT
   of the directory (or device) in the S gadget, including ALL files and
   subdirectories, BUT NOT directory itself. (This leaves an empty, but
   existing, directory.

Example:
1) Delete all files in df1:devs (but not df1:devs itself). Put df1:devs
   in S and go. This leaves an empty df1:devs as the S directory.
2) Delete its files AND IT, TOO. Put 'df1:' in S and select 'devs'
   with one click. Then hit ZAPALL twice (once to select ZAPALL, once to
   CONFIRM ZAPALL), and all the files and directories in 'devs' will be
   deleted, then devs will be deleted (unless it is ASSIGNed to devs:).

Gives message area progress reports. Deletes files alphabetically backward,
recursing into directories as encountered.  Watch and see.

  R+ R-
  -----
Scroll R history.  READ 'HISTORY' EXPLANATION.
 LEFT mouse  = +
 RIGHT mouse = -

  f->R  f->D
  ----  ----
Move FIRST highlighted file (OR directory) into indicated gadget.
 RIGHT mouse on f->D = CONCAT the first item into D (with / if needed).

  R->S  R->D  etc.
  ----  ----
Copy current gadget contents around. If R involved, affected history item
is updated. IF S involved, it is treated like a new entry.

  R<->S  etc.
  -----
Two-way swaps of gadget content. S<->D is the old SWAP command. If S is
involved, it will be treated as though typed in fresh. If R gadget is
involved, affected history item is updated.

+++++++++++++++++++++
TOGGLE (FLAG) GADGETS
+++++++++++++++++++++

  PROTECT/ERASE/REPLACE
  ---------------------
Indicates protection used for files at destination end of COPY and MOVE.
(Not honored by COPYALL, COPYif, or ZAPALL, which must be confirmed.)

 1. PROTECT - Don't continue if same name file EXISTS at destination.
 2. ERASE   - Don't care about file of same name at destination.
 3. REPLACE - Don't continue UNLESS file of same name EXISTS at destination.

  DevNAME/VolNAME
  ---------------
Indicates what type of names S gadget will use.

 1. DevNAME -  df0:??  df1:?? etc. will be used.
 2. VolNAME -  disk names (MyVol:??) will be picked up.

May be useful where one drive swaps are involved.

Drawback in VolNAME mode. ASSIGNed names like devs: can't be used. Program
assumes you want Volume Name of the disk that ASSIGNed device is on and
goes to the root expressed as volume name.

  SIZES/DATES
  ===========
Indicates what to display about files. Changes when hit.

 1. SIZES - byte file size will show.
 2. DATES - creation dates will show.


  SysDATE/OldDATE
  ===============
Select date to put on copied files.

 1. SysDATE - current system date goes on copies.
 2. OldDATE - creation date of source file goes on copies.

  PRT: PAR: SER:
  ==============
Shows destination of PRINT/HPRINT gadgets. (See Patching.)

 = - = - = - = - = MOST PEOPLE - CUT HERE = - = - = - = - = - = - =

                   PATCHING [with NewZap]

Editor name:
 Change only occurrance of 'dme' (no quotes) to a null terminated string of
 your choice. Space for up to a 10 character name.

Default PRINT/HPRINT output device:
 Find only occurrance of PRT:<0>PAR:<0>SER:<0>.  The first is default
 on startup. Swap order to your preferences, remembering to keep them 4
 characters long plus nullterm.

Devices - df0: df1: ... etc.:
 If you have a different named device (like nv0: or dh2: or something), you
 can find the only place where the names appear in an ordered set of null
 terminated strings.  THIS IS BOTH GADGET TEXT AND TEXT USED TO TRY TO LOCK
 THE DEVICE. Rearrange or change what's there (with up to 4 letters each).
 Whatever you put into the ram: (last) gadget will be what is logged into
 first from WorkBench.  What appears in each gadget will be what the program
 tries to access and CurrentDir to when it is selected. Be careful.